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In step 706, the file transfer procedure 126 receives the 
input_args parameter. 

In step 708, the file transfer procedure 126 uses the 
pointers in the sqlvars of fee input_args parameter to 
retrieve the file name(s) of the file(s) associated with the 5 
procedure 112. The use of pointers to reference memory 
areas, and to retrieve data from such memory areas, is well 
known. 

In step 710, the file transfer procedure 126 uses the 
pointers in the sqlvars of the input_args parameter to 10 
retrieve the string representation(s) of the file(s) associated 
with the procedure 112. 

In step 712, the file transfer procedure 126 uses the 
pointers in the sqlvars of the input_args parameter to 
retrieve the target path. 15 

In step 714, the file transfer procedure 126 writes the 
string representation(s) (retrieved in step 710) to file(s) 
(preferably one file per string representation). The procedure 
for writing a string to a file is analogous to the procedure for 1 
converting a file to a string (described above), and will be 20 
apparent to persons skilled in the relevant art(s). The files are 
written under the file names retrieved in step 708. The file 
format is implementation dependent. 

While various embodiments of the present invention have 
been described above, it should be understood that they have 25 
been presented by way of example only, and not limitation. 
Thus, the breadth and scope of the present invention should 
not be limited by any of the above-described exemplary 
enftodiments, but should be defined only in accordance with 
the following claims and their equivalents. 30 

Having thus described our invention, what we claim as I 
new and desire to secure by Letters Patent is: ! 

U . A method of transferring a file from a client platform to f 
a S X Cr pla Jf orm ' me scrver platform coupled to the client 
platftffm, a "DB2" relational database management system 35 
(RDBMS) executing on the server platform, the method 
comprising the steps of: 

(1) at the client platform, converting the file to a string; 

(2) at the^lient platform, causing a pointer in an input_ ^ 
args parameter to point to said string, said input_args 
parameter\being of a "sqldV data type, said pointer 
being part dfa "sqlvar" parameter defined by the sqlda 
data type, the^qlda data type being suitable for passing 
scalar values to^procedures; and 45 

(3) at the client platrorm, invoking a "sqleproc" function 
provided by a "client application enablement" (CAE) 
module, the CAE module being resident in the client 
platform and representing a client component of the 
DB2 RDBMS, a r^amkter list of said sqteproc func- 50 
tion comprising said input_args parameter and a 
procedure_to_jnvoke parameter that identifies an 
user-specified procedure located on the server platform, 
said sqleproc function when Waited causing said 
inpuL_args parameter to be passed to said user- 55 
specified procedure at the sorer platform, and also 
causing said user-specified procedure^ to be invoked at 
the server platform. \ 

2. A method of transferring a file from a cHtent platform to 
a server platform, the client platform coupleo\o the server ^ 
platform, a "DB2" relational database management system 
(RDBMS) executing on the server platform, th\ method 
comprising the steps of: \ 

(1) at the client platform, converting the file to a l „ & , 

(2) atfeecUentpktfonn.sem^gaprocedure_to^\oke 65 
parameter equal to information identifying a file tra 
fer procedure located at the server platform; 
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(3) at the client platform, causing a pointer in a first 
"sqlvar" parameter to point to said string, and causing 

v a pointer in a second sqlvar parameter to point to a file 
name of the file, the first and second sqlvar parameters 
5 being part of an input_args parameter, the input_args 
parameter having a "sqlda" data type, the sqlda data 
type^being suitable for passing scalar values to proce- 
dures; and 

(4) at theNclient platform, invoking a "sqleproc" function 
xo provided by a "client application enablement" (CAE) 

module, the CAE module being resident in the client 
platform and representing a client component of the 
DB2 RDBMS, a parameter list of said sqleproc func- 
tion comprising said input_args parameter and said 

15 procedure_to_Jnvoke parameter, said sqleproc func- 
tion when executed causing said inpuL_args parameter 
to be passed to.said file transfer procedure at the server 
platform, and also causing said file transfer procedure 
to be invoked at the server platform. 

20 3. The method of clMrn 2, further comprising the steps of: 

(5) at the server platform, receiving the inpwt_args 
parameter; \ 

(6) at the server platform, using said pointer in said first 
sqlvar parameter of the input__args parameter to access 

25 and retrieve said string; 

(7) at the server platform, using said pointer in said 
second sqlvar parameterVf the inpuL_args parameter to 
access and retrieve said rUe name; and 

(8) at the server platform, writing said string to a new file 
30 in the server platform using said file name. 

4. The method of claim 3, further comprising the step of: 

(9) at the client platform, causing a pointer in a third 
sqlvar parameter to point to a\ target path string. 

5. The method of claim 4, rurthervcomprising the step of: 
35 ( 10) at the server platform, using said pointer in said third 

sqlvar parameter of the inputs arcs parameter to access 
and retrieve said target path string; 
wherein step (8) comprises the stepW: 
40 at the server platform, writing said ^fring to a new file 
using said file name at a location in said server platform 
identified by said target path stringA 

6. A method of transferring a file from anient platform to 
a server platfornL the client platform coupled to the server 

45 platform, a "DB2" relational database management system 
(RDBMS) executing on the server platform, the method 
comprising the steps of: 

(1) at the server platform, receiving an input V args param- 
eter being of a "sqlda" data type, said\ input_args 

5q parameter comprising a "sqlvar** parameteAdefined by 
said sqlda data type, said sqlvar parameter comprising 
a pointer pointing to a string that was transferred from 
the client platform to the server platform, said string 
being a string representation of a file located on the 

55 client platform; \ 

(2) at the server platform, using said pointer in said sqlvar 
parameter of the input_args parameter to access and 
retrieve said string; \ 

(3) at the server platform, writing said string to a new file. 
60 7. The method of claim 6, wherein said inputjargs 

parameter comprises a second sqlvar parameter having a 
pointer that points to a file name of said file, and a third 
sqlvar parameter having a pointer that points to a target path 
string, the method further comprising the steps of: \ 
65 (4) at the server platform, using said pointer in said 
second sqlvar parameter of the input_args parameter to 
access and retrieve said file name; and 
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\(5) at the server platform, using said pointer in said third 
sqlvar parameter of the input_args parameter to access 
and retrieve said target path string; 
wherein step (3) comprises the step of: 
\ at the server platform, writing said string to a new file 
\ using said file name at a location in said server 
\ platform identified by said target path string. 
8. A method for enabling an user to distribute a procedure 
from a client platform to a plurality of server platforms, and 
for enabling the user to make and register the procedure at 
the server Wtf arms, a "DB2" relational database manage- 
ment system (RDBMS) executing on each server platform, 
comprising \he steps of: 

(1) at the client platform, displaying a list of servers; 

(2) at the client platform, enabling the user to select any 
of said 

(3) at the client platform, commanding a "client applica- 
tion enablerrient" (CAE) module to distribute a file 

i the procedure to the selected servers, 
; being resident in the client platform 
bg a client component of the DB2 



associated w. 
the CAE m< 
and represem 
RDBMS; and 
(4) at the client ; 
to cause the sell 
procedure; 
wherein step (3) CO] 

(a) converting the 

(b) setting a procedi 
information idem 
located at each sele< 



[arm, commanding the CAB module 
d servers to make and register the 



;es the steps of: 
to a string; 
.to__invoke parameter equal to 
ig a file transfer procedure 
d server, 



(c) causing a pointer in 
point to said string, 
sqlvar parameter to poini 
first and second sqlvar 
input__args parameter, 



first "sqlvar" parameter to 
sing a pointer in a second 
a file name of the file, the 
Leters being part of an 
inpuL_args parameter 



having a "sqlda" data typeAthe sqlda data, type being 
suitable for passing scalar Values to procedures; and 
(d) invoking for each selected server a "sqleproc" 
function provided by the CAE module, a parameter 
list of said sqleproc function comprising said inpuL_ 
args parameter and said procedure^. to__invoke 
parameter, said sqleproc function when executed 
causing said input_args parameter to be passed to 
said file transfer procedure at each selected server, 
and also causing said file transfer procedure to be 
invoked at each selected server. 

9. The method of claim 8, further connprfising the steps of: 

(5) at each server, receiving the input_aW parameter; 

(6) at each server, using said pointer in skid first sqlvar 
parameter of the input__args parameter \o access and 
retrieve said string; 

(7) at each server, using said pointer in said second sqlvar 
parameter of the input_args parameter to\ access and 
retrieve said file name; and 

(8) at each server, writing said string to a new fcle in said 
each server using said file name. 

10. The method of claim 8, wherein step (4) comprises the 
step of: 

setting the procedure_to_Jnvoke parameter ebual to 
information identifying a make function locatedpt each 
selected server; and 

invoking for each selected server the "sqleproc" function, 
said sqleproc function when executed causing 
selected server to invoke the make function, the 
function when executed operating to make the 
dure. 
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11. The method of claim 8, wherein step (4) comprises the 
step of: 

setting the procedure to_jnvoke parameter equal to 
information identifying a registration function located 
at each selected server; and 
invoking for each selected server the "sqleproc" function, 
said sqleproc function when executed causing each 
selected server to invoke the registration function, the 
registration function when executed operating to reg- 
10 ister the procedure with the DB2 RDBMS at said each 
selected server. 

12. A system of transf erring a file from a client platform 
to a serverplarf orm, the client platform coupled to the server 
platform, a\"DB2 w relational database management system 
(RDBMS) executing on the server platform, the system 
comprising: \ 

means, at the client platform, for converting the file to a 
string; \ 

means, at the client platform, for setting a procedure_ 
to_jnvoke parameter equal to information identifying a 
file transfer procedure located at the server platform; 
means, at the client platform, for causing a pointer in a 
first "sqlvar** parameter to point to said string, and 
causing a pointer in a second sqlvar parameter to point 
to a file name of the file, the first and second sqlvar 
25 parameters being\part of an input_args parameter, the 
input_args parameter having a "sqlda** data type, the 
sqlda data type being suitable for passing scalar values 
to procedures; and \ 
means, at the client platform, for invoking a "sqleproc** 
30 function provided by aY*client application enablement** 
(CAE) module, the C/fe module being resident in the 
client platform and representing a client component of 
the DB2 RDBMS, a parameter list of said sqleproc 
ill. function comprising saia input_args parameter and 

33 said prccedure_to_JnvoKe parameter, said sqleproc 
* : s „ function when execu ted \ causing said input_args 

== J parameter to be passed to said file transfer procedure at 

J Z the server platform, and also causing said file transfer 

i==l procedure to be invoked at the server platform. 

40 13. The system of claim 12, further comprising: 

means, at the server platform, for receiving the input_ 

args parameter; \ 
means, at the server platform, forms ing said pointer in 
said first sqlvar parameter of the mput_args parameter 
to access and retrieve said stringA 
means, at the server platform, for using said pointer in 
said second sqlvar parameter of the input_args param- 
eter to access and retrieve said file name; and 
writing means, at the server platform, \f or writing said 
string to a new file in the server platform using said file 
name. \ 

14. The system of claim 13, further comprising: 
means, at the client platform, for causing a pointer in a 

55 third sqlvar parameter to point to a target\path string. 

15. The system of claim 14, further comprising: 
means, at the server platform, for using saidApointer in 

said third sqlvar parameter of the input args parameter 

to access and retrieve said target path stringA 
60 wherein said writing means includes means f on writing 
said string to a new file using said file name at a 
location in said server platform identified by saimtarget 
path string. \ 

16. A server platform coupled to a client pktforW a 
65 "DB2" relational database management system (RDBMS) 

executing on the server platform, the server platform com- 
prising: 
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means for receiving an input_args parameter being of a 
"sqlda" data type, said input_args parameter compris- 
ing a "sqlvar" parameter defined by said sqlda data 
type, said sqlvar parameter comprising a pointer point- 
ing to a string that was transferred from the client 
platform to the server platform, said string being a 
string representation of a file located on the client 
platform; 

means for using said pointer in said sqlvar parameter of 
the input_args parameter to access and retrieve said 
string; and 

writing means for writing said string to a new file in the 

server platform. 
17. The\server platform of claim 16, wherein said input_ 
args parameter comprises a second sqlvar parameter having 
a pointer that points to a file name of said file, and a third 
sqlvar parameter having a pointer that points to a target path 
string, the server platform further comprising: 
means for using said pointer in said second sqlvar param- 
eter of the input_args parameter to access and retrieve 
said file name; and 

means for usingysaid pointer in said third sqlvar parameter 
of the input_.args parameter to access and retrieve said 
target path str&ig; 

wherein said writing means comprises means far writing 
said new file using said file name at a location in said 
server platform identified by said target path string. 

for enabling an user to distribute a 
platform to a plurality of server 
ig the user to make and register the 
? orms, a "DB2" relational data- 
(RDBMS) executing on each 
server platform, the database system comprising: 
means, at the client platform, for displaying a list of 
servers; 

means, at the client platf< 
select any of said servi 
CAE commanding means, tet the client platform, far 
commanding a "client application enablement" (CAE) 
module to distribute a file associated with the procedure 
to the selected servers, the CAE module being resident 
in the client platform and representing a client compo- 
nent of the DB2 RDBMS; an) 
make and register means, at trie client platform, far 
commanding the CAE moduleuo cause the selected 
servers to make and register theVprocedure; 
wherein said CAE commanding means comprises: 
means for converting the file to a Wring; 
means for setting a procedure_toVinvoke parameter 
equal to information identifying^ file transfer pro- 
cedure located at each selected server; 
means for causing a pointer in a first "sqlvar" parameter 
to point to said string, and causina a pointer in a 
second sqlvar parameter to point to anle name of the 
file, the first and second sqlvar parameters being part 
of an input_args parameter, the inputLargs param- 
eter having a "sqlda n data type, the sqfoa data type 
being suitable for passing scalar values to proce- 
dures; and \ 
means for invoking for each selected! 
"sqleproc" function provided by the CAE 
parameter list of said sqleproc function c 
said input_args parameter and said procedufe_to_I 
invoke parameter, said sqleproc functiom when 
executed causing said input_args parameteAto be 



18. A database systei 
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passed to said file transfer procedure at each selected 
server, and also causing said file transfer procedure 
to be invoked at each selected server. 
J.9. The database system of claim 18, further comprising: 
at each server, for receiving the input_args 
parameter; 

at each server, for using said pointer in said first 
rar parameter of the input_args parameter to access 
an&retrieve said string; 
means,>at each server, far using said pointer in said second 
sqlvak parameter of the input_args parameter to access 
and retrieve said file name; and 
means, at each server, for writing said string to a new file 
in the server using said file name. 

20. The system of claim 18, wherein said make and 
register means comprises: 

means for setting the procedure_to_Jnvoke parameter 
equal to information identifying a make function 
located at each selected server; and 

means for invoking for each selected server the 
"sqleproc" function, said sqleproc function when 
executed causing, each selected server to invoke the 
make function, the make function when executed oper- 
ating to make the procedure. 

21. The system of claim 18, wherein said make and 
register means comprises*. 

means for setting the procedure_to_Jnvoke parameter 
equal to information identifying a registration function 
located at each selected server; and 

means for invoking fok each selected server the 
"sqleproc** function, said sqleproc function when 
executed causing each selected server to invoke the 
registration function, the registration function when 
executed operating to register the procedure with the 
DB2 RDBMS at said each selected server. 

22. A program storage device Wadable by a machine, 
tangibly embodying a program of instructions executable by 
the machine to perform method steos for transferring a file 
from a client platform to a serves platform, the server 
platform coupled to the client platform, a "DB2" relational 
database management system (RDBMS) executing on the 
server platform, said method steps comprising: 

(1) at the client platform, con verting W file to a string; 

(2) at the client platform, causing a pointer in an input_ 
args parameter to point to said strings said input_args 
parameter being of a "sqlda** data type, said pointer 
being part of a "sqlvar** parameter defined by the sqlda 
data type, the sqlda data type being suitable for passing 
scalar values to procedures; and \ 

(3) at the client platform, invoking a "sqleproc** function 
provided by a "client application enablement** (CAE) 
module, the CAE module being resident m the client 
platform and representing a client component of the 
DB2 RDBMS, a parameter list of said sqleproc func- 
tion comprising said input_args parameter and a 
procedure_to_Jnvoke parameter that identifies an 
user-specified procedure located on the server platform, 
said sqleproc function when executed causing said 
input__args parameter to be passed to said\user- 
specified procedure at the server platform, anal also 
causing said user-specified procedure to be invoked at 
the server platform \ 

23. A program storage device readable by a machine, 
tangibly embodying a program of instructions executable \y 
the machine to perform method steps for transferring a file 
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from a client platform to a server platform, the client 
platform coupled to the server platform, a "DB2" relational 
database management system (RDBMS) executing on the 
server platform, said method steps comprising: 

(1) at the client platform, converting the file to a string; 

(2) at the client platform, setting a procedure_to_Jnvoke 
parameter equal to information identifying a file trans- 
fer procedure located at the server platform; 

(3) at\ the client platform, causing a pointer in a first 
"sqlvar" parameter to point to said string, and causing 
a pointer in a second sqlvar parameter to point to a file 
name of the file, the first and second sqlvar parameters 
being part of an input_args parameter, the input_args 
parameHtf having a "sqlda" data type, the sqlda data J5 
type being suitable for passing scalar values to proce- 
dures; an< 

(4) at the client platform, invoking a "sqleproc** function 
provided by\a "client application enablement** (CAE) 
module, the CAE module being resident in the client 20 
platform and representing a client component of the 
DB2 RDBMS /a parameter list of said sqleproc func- 
tion comprising^ said input_args parameter and said 
procedure_to_Jnyoke parameter, said sqleproc func- 
tion when executed causing said input_args parameter 25 
to be passed to saia file transfer procedure at the server 
platform, and also causing said file transfer procedure 

to be invoked at theVerver platform. 

24. The program storage device of claim 23, said method 
steps further composing the steps of: 30 

(5) at the server platform, receiving the input_args 
parameter; 

(6) at the server platform, using said pointer in said first 

sqlvar parameter of the input args parameter to access 

and retrieve said string; \ 35 

(7) at the server platform, using said pointer in said 
second sqlvar parameter of the input__args parameter to 
access and retrieve said file name; and 

(8) at the server platform, writin&said string to a new file 

in the server platform using said file name. 40 

25. The program storage device of Iclaim 24, said method 
steps further comprising the step of: 

(9) at the client platform, causing a pointer in a third 
sqlvar parameter to point to a target path string. 45 

26. The program storage device of claim 25, said method 
steps further comprising the step of: 

(10) at the server platform, using said pointer in said third 
sqlvar parameter of the input_args parameter to access 
and retrieve said target path string; \ 50 
wherein step (8) comprises the step of: 
at the server platform, writing said string to a new file 

using said file name at a location inlaid server 
platform identified by said target path string. 

27. A program storage device readable by a\ machine, 55 
tangibly embodying a program of instructions executable by 
the machine to perform method steps for transferruig a file 
from a client platform to a server platform, the client 
platform coupled to the server platform, a "DB2** relational 
database management system (RDBMS) executing\on the go 
server platform, said method steps comprising: 

(1) at the server platform, receiving an input_args p; 
eter being , of a "sqlda" data type, said input 
parameter comprising a "sqlvar** parameter defini 
said sqlda data type, said sqlvar parameter coi 
a pointer pointing to a string that was transferred 
the client platform to the server platform, said si 
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being a string representation of a file located on the 
X client platform; 

\ (2) at the server platform, using said pointer in said sqlvar 
\ parameter of the input_args parameter to access and 
5 \ retrieve said string; 

\ (3) at the server platform, writing said string to a new file. 
\28. The program storage device of claim 27, wherein said 

input_args parameter comprises a second sqlvar parameter 

having a pointer that points to a file name of said file, and 
10 a third sqlvar parameter having a pointer that points to a 

target path string, said method steps further comprising the 

steps of: 

(4) Vt the server platform, using said pointer in said 
15 second sqlvar parameter of the input_args parameter to 

access and retrieve said file name; and 

(5) at the server platform, using said pointer in said third 
sqlvar parameter of the input_args parameter to access 
and retrieve said target path string; 

20 wherein step (3) comprises the step of: 

at the server platform, writing said string to a new file 
using\said file name at a location in said server 
platform identified by said target path string. 

29. A program storage device readable by a machine, 
25 tangibly embodying a program of instructions executable by 

the machine to perform method steps for enabling an user to 
distribute a procedure from a client platform to a plurality of 
server platforms\ and for enabling the user to make and 
register the procedure at the server platforms, a *DB2" , 
30 relational database^ management system (RDBMS) execut- 
ing on each server platform, said method steps comprising: 

(1) at the client platform, displaying a list of servers; 

(2) at the client platform, enabling the user to select any 
of said servers; \ 

(3) at the client platform, commanding a "client applica- 
tion enablemenf * VCAE) module to distribute a file 
associated with theyprocedure to the selected servers, 
the CAE module being resident in the client platform 

4- and representing a\client component of the DB2 
. RDBMS; and x 

(4) at the client platformX commanding the CAE module 
to cause the selected servers to make and register the 
procedure; 

45 wherein step (3) comprises the steps of: 

(a) converting the file to aXstring; 

(b) setting a rrocedure_to.Ainvoke parameter equal to 
information identifying a file transfer procedure 
located at each selected server, 

50 (c) causing a pointer in a firs\ "sqlvar" parameter to 
point to said string, and causing a pointer in a second 
sqlvar parameter to point to a file name of the file, the 
first and second sqlvar parameters being part of an 
input_args parameter, the inpirt args parameter 

55 having a "sqlda" data type, the sqlda data type being 

suitable for passing scalar values to procedures; and 
(d) invoking for each selected server a "sqlep-oc" 
function provided by the CAE module, a parameter 
list of said sqleproc function comprising said input_ 

60 args parameter and said procedureV to_jnvoke 

parameter, said sqleproc function when executed 
causing said input_args parameter to be\passed to 
said file transfer procedure at each selected server, 
and also causing said file transfer procedure to be 

65 invoked at each selected server. \ 

30. The program storage device of claim 29. said method 
steps further comprising the steps of; \ 
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(5) at each server, receiving the iuput^args parameter; 
(6X at each server, using said pointer in said first sqlvar 

parameter of the input__args parameter to access and 

retrieve said string; 

(7) at each server, using said pointer in said second sqlvar 
parameter of the input_args parameter to access and 
retrievers aid file name; and 

(8) at each server, writing said string to a new file in said 
each server^! sing said file name. 

3L The program storage device of claim 29, wherein step 
(4) comprises the step of: 

setting the j^ocechire_to_jnvoke parameter equal to 
information identifying a make function located at each 
selected server; an 

invoking for each selecied server the "sqleproc" function, 
said sqleproc functionV when executed causing each 
selected server to invoke^the malm function, the maVe 
function when executed operating to make the proce- 
dure. \ 

32. The program storage deviceV claim 29, wherein step 
(4) comprises the step of: \ 

setting the procedure_to_Jnvoke\parameter equal to 
information identifying a registrafion function located 
at each selected server, and \ 
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invoking for each selected server the "sqleproc" function, 
said sqleproc function when executed causing each 
selected server to invoke the registration function, the 
5 registration function when executed operating to reg- 
ister the procedure with the DB2 RDBMS at said each 
selected server. 

33. The method of claim 1, wherein said file is a vector 
file. 

10 34. Hie method of claim 2, wherein said file is a vector 
file. 

35. The method of claim 6, wherein said file is a vector 
file. 

15 36. The system of claim 12, wherein said file is a vector 
file. 

37. The program storage device of claim 22, wherein said 
file is a vector file. 

20 38. The program storage device of claim 23, wherein said 
file is a vector file. 

39. The program storage device of claim 27, wherein said 
file is a vector file. 
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invoking for each selected server the "sqleproc" function, 
said sqleproc function when executed causing each 
selected saver to invoke the registration function, the 
registration function when executed operating to reg- 
ister the procedure with the DB2 RDBMS at said each 
selected server. 

33. The method of claim 1, wherein said file is a vector 
file. 

10 34. The method of claim 2, wherein said file is a vector 
file. 

35. The method of claim 6, wherein said file is a vector 
file. 

15 36. The system of claim 12, wherein said file is a vector 
file. 

37. The program storage device of claim 22, wherein said 
file is a vector file. 

20 38. The program storage device of claim 23, wherein said 
file is a vector file. 

39. The program storage device of claim 27, wherein said 
file is a vector file. 
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